3D Graphics Programming with QuickDraw 3D 1.5.4

Picking With Window Points

QuickDraw 3D provides routines that you can use to pick with window points. The location of the point is in the resolution of the current draw context.

Q3WindowPointPick_New

You can use the Q3WindowPointPick_New function to create a new window-point pick object.



 
TQ3PickObject Q3WindowPointPick_New (

                     const TQ3WindowPointPickData *data);

data: A pointer to a window-point pick data structure.

DESCRIPTION

The Q3WindowPointPick_New function returns, as its function result, a new window-point pick object having the characteristics specified by the data parameter. If Q3WindowPointPick_New fails, it returns NULL .

Q3WindowPointPick_GetPoint

You can use the Q3WindowPointPick_GetPoint function to get the point of a window-point pick object.



 
TQ3Status Q3WindowPointPick_GetPoint (

                     TQ3PickObject pick, 

                     TQ3Point2D *point);

pick: A window-point pick object.
point: On exit, the current point of the specified window-point pick object.

DESCRIPTION

The Q3WindowPointPick_GetPoint function returns, in the point parameter, the current point of the window-point pick object specified by the pick parameter.

Q3WindowPointPick_SetPoint

You can use the Q3WindowPointPick_SetPoint function to set the point of a window-point pick object in screen space.



 
TQ3Status Q3WindowPointPick_SetPoint (

                     TQ3PickObject pick, 

                     const TQ3Point2D *point);

pick: A window-point pick object.
point: The desired point for the specified window-point pick object.

DESCRIPTION

The Q3WindowPointPick_SetPoint function sets the point of the window-point pick object specified by the pick parameter to the point specified by the point parameter.

Q3WindowPointPick_GetData

You can use the Q3WindowPointPick_GetData function to get the data associated with a window-point pick object.



 
TQ3Status Q3WindowPointPick_GetData (

                     TQ3PickObject pick, 

                     TQ3WindowPointPickData *data);

pick: A window-point pick object.
data: On exit, a pointer to a window-point pick data structure.

DESCRIPTION

The Q3WindowPointPick_GetData function returns, through the data parameter, information about the window-point pick object specified by the pick parameter. See "Window-Point Pick Data Structure" for a description of a window-point pick data structure.

Q3WindowPointPick_SetData

You can use the Q3WindowPointPick_SetData function to set the data associated with a window-point pick object.



 
TQ3Status Q3WindowPointPick_SetData (

                     TQ3PickObject pick, 

                     const TQ3WindowPointPickData *data);

pick: A window-point pick object.
data: A pointer to a window-point pick data structure.

DESCRIPTION

The Q3WindowPointPick_SetData function sets the data associated with the window-point pick object specified by the pick parameter to the data specified by the data parameter.